Approve an intercompany transfer (pending_approval -> approved)
Approves an intercompany transfer sitting in pending_approval status,
advancing it to approved and recording approved_by, approved_at,
and optional approval_notes. Internal transfers cannot be approved
(they ship via submit and bypass the approval gate).
State guard: returns 400 when the transfer is not intercompany or
when status is not pending_approval. AUDIT-089 fires the
transfer.approved broadcast to BOTH entities.
Requires inventory:approve scope (higher tier than inventory:write).
Idempotent via Idempotency-Key.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Response
Approved transfer (hydrated)

